home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / thor / thor_api / readme.api
Text File  |  1996-10-20  |  4KB  |  81 lines
  1. 961020                  Thor 2.4 API documentation
  2.  
  3.   Copyright © 1994-1996 Ultima Thule Software, All Rights Reserved.
  4.         Authors: Eivind Nordseth, Kjell Irgens, Petter Nilsen
  5.  
  6. This  API documentation package is NOT public domain, but it is freely
  7. distributable.   In  other  word  it is FreeWare.  (Note:  Thor 2.4 is
  8. ShareWare.)  This  means  that  you  can  copy  this API documentation
  9. package and give it to all your friends, upload it to a BBS or include
  10. it  in  a  PD-library.   The  only  restrictions  are:   All the files
  11. included  in  this  archive  must  be  in  their original form without
  12. additions,  deletions  or  modifications  of  any  kind.  Thor 2.4 API
  13. documentation  may  not  be  distributed  for  profit.  Only a nominal
  14. charge  may  be  associated  with  its distribution.  The Thor 2.4 API
  15. documentation  is  provided  "AS IS" without warranty of any kind, and
  16. the  authors  is  not responsible for any damage this software may do.
  17. (Just in case :-)
  18.  
  19. Do not release any modifications of the code examples included in this
  20. package.   If  you  have  suggestions  for  code  improvements, please
  21. contact the authors.
  22.  
  23.  
  24. INTRODUCTION
  25. ~~~~~~~~~~~~
  26. The Thor API documentation package consists of:
  27.  
  28. o docs/bbsread.doc  -  Autodoc for V4 of bbsread.library.
  29. o include/#?        -  Include files for V4 of bbsread.library.
  30. o parsemsg/#?       -  Source code of a message parser, which adds messages
  31.                        from ABBS/MBBS to the message database. Will also 
  32.                        parse newfiles lists and conference lists.
  33. o scriptserv/#?     -  Source code for a script server. This program is 
  34.                        used by the ABBS/MBBS Ncomm scripts to gain knowledge
  35.                        of the different events to do. It has also other 
  36.                        features used by this NComm script.
  37. o packhippo/?#      -  Source code for an events packer, which makes upload 
  38.                        packets in Hippo format.
  39. o common/#?         -  Some small code stubs which are common for scriptserv
  40.                        and parsemsg.
  41. o WatchTHOR/#?      -  Source code for the WatchTHOR mail notification
  42.                        utility. 
  43.  
  44. Some   of  the  source  uses  utgui.library  for  displaying  progress
  45. requesters.   The  api for utgui.library is not included here.  (Since
  46. the utgui.library probably will be obsolete in later versions of Thor,
  47. the  docs  for  utgui.library is not released.) If you want to compile
  48. the soures which uses utgui.library, you must comment out all calls to
  49. utgui.library.
  50.  
  51.  
  52. HOW TO USE
  53. ~~~~~~~~~~
  54. We have not included any detailed step by step guide to how to program
  55. utilites and modules for Thor.
  56.  
  57. Some general advices:
  58.  
  59. o You should read the source code provided, docs/bbsread.doc and
  60.   include/libraries/bbsread.h carefully before doing any programming.
  61.  
  62. o If you are to write a module for Thor, you should first make a working
  63.   message parser. After the parser is up and running, you should set up the
  64.   event configuration for the events you want to support, and then make a
  65.   event packer.
  66.  
  67. o If you are uncertain of how to use any of the provided functions, look
  68.   into the source code examples to see how thay are used there. If you
  69.   still are uncertain, send us an email and we'll try to answer your
  70.   questions.
  71.  
  72. If you have any questions regarding the use of the Thor 2.3 API we are
  73. reachable on the Thor support email address:  thor@hstud6.cs.uit.no
  74.  
  75.  
  76. HISTORY
  77. ~~~~~~~
  78. 951105 - Initial release of the API documentation
  79. 950524 - THOR 2.3 API documentation, no changes except for the archive name
  80. 951020 - THOR 2.4 API documentation, minor header files changes
  81.